home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / touch.z / touch
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. ttttoooouuuucccchhhh((((1111))))                                                              ttttoooouuuucccchhhh((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _tttt_oooo_uuuu_cccc_hhhh - update access and modification times of a file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _tttt_oooo_uuuu_cccc_hhhh [ _----_aaaa_mmmm_cccc ] [ _m_m_d_d_h_h_m_m[_y_y] ] _f_i_l_e_s
  13.  
  14.      _tttt_oooo_uuuu_cccc_hhhh [ _----_aaaa_mmmm_cccc ] [ _----_rrrr _r_e_f__f_i_l_e | _----_tttt [[_c_c]_y_y]_m_m_d_d_h_h_m_m[._s_s] ] _f_i_l_e_s
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _tttt_oooo_uuuu_cccc_hhhh causes the access and modification times of each argument to be
  18.      updated.  The file name is created if it does not exist.  If no time is
  19.      specified [see _dddd_aaaa_tttt_eeee(1)] the current time is used.  The _----_aaaa and _----_mmmm options
  20.      cause touch to update only the access or modification times respectively
  21.      (default is _----_aaaa_mmmm).  The _----_cccc option silently prevents _tttt_oooo_uuuu_cccc_hhhh from creating
  22.      the file if it did not previously exist.  The _----_rrrr option causes touch to
  23.      use the modification time of the file named by the pathname _r_e_f__f_i_l_e
  24.      instead of of the current time.
  25.  
  26.      The _----_tttt [[_c_c]_y_y]_m_m_d_d_h_h_m_m[._s_s] option specifies to the time to use instead
  27.      of the current time.  The option-argument will be a decimal number where
  28.      each two digits represents the following:
  29.  
  30.  
  31.           _m_m   The month of the year [01-12].
  32.  
  33.           _d_d   The day of the month [01-31].
  34.  
  35.           _h_h   The hour of the day [00-23].
  36.  
  37.           _m_m   The minute of the hour [00-59].
  38.  
  39.           _c_c   The first two digits of the year (century).
  40.  
  41.           _y_y   The second two digits of the year.
  42.  
  43.           _s_s   The second of the minute [00-61].
  44.  
  45.           Both _c_c and _y_y are optional.  If neither is given, the current year
  46.           will be assumed.  If _y_y is specified, but _c_c is not, _c_c will be
  47.           derived as follows:
  48.  
  49.                If _y_y _i_s: _6_9-_9_9 then _c_c becomes _1_9.
  50.  
  51.                If _y_y _i_s: _0_0-_6_8 then _c_c becomes _2_0.
  52.  
  53.           The range for _s_s is (00-61) rather than (00-59) because of leap
  54.           seconds.  If _s_s is 60 or 61, and the resulting time, as affected by
  55.           the _T_Z environment variable, does not refer to a leap second, the
  56.           resulting time will be one or two seconds after a time where _s_s is
  57.           59.  If _s_s is not given a value, it is assumed to be zero.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ttttoooouuuucccchhhh((((1111))))                                                              ttttoooouuuucccchhhh((((1111))))
  71.  
  72.  
  73.  
  74.      The return code from _tttt_oooo_uuuu_cccc_hhhh is the number of files for which the times
  75.      could not be successfully modified (including files that did not exist
  76.      and were not created).
  77.  
  78. FFFFIIIILLLLEEEESSSS
  79.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_uuuu_xxxx_cccc_oooo_rrrr_eeee_...._aaaa_bbbb_iiii
  80.           language-specific message file [See _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn (5).]
  81.  
  82. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  83.      _dddd_aaaa_tttt_eeee(1), _uuuu_tttt_iiii_mmmm_eeee(2)
  84.  
  85. NNNNOOOOTTTTEEEESSSS
  86.      Users familiar with the BSD environment will find that the _----_ffff option is
  87.      accepted, but ignored.  The _----_ffff option is unnecessary since _tttt_oooo_uuuu_cccc_hhhh will
  88.      succeed for all files owned by the user regardless of the permissions on
  89.      the files.
  90.  
  91.      If no _----_rrrr option is specified, no _----_tttt option is specified, at least two
  92.      operands are specified, and the first operand is an eight- or ten-digit
  93.      decimal integer, the first operand will be assumed to be a date-time
  94.      specification of the form mmddhhmm[yy].  Otherwise, the first operand
  95.      will be assumed to be a file name.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.